home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / util / wb / iconspy1.lha / IconSpy / IconSpy.doc < prev    next >
Text File  |  1994-10-27  |  5KB  |  165 lines
  1.  
  2. *******************************************************************************
  3.  
  4.                              »»» IconSpy v1.2 «««
  5.  
  6.                        Beetware © 1994 The Beet Research
  7.  
  8.                          written by Grzegorz Calkowski
  9.  
  10. *******************************************************************************
  11.  
  12.  
  13. Well, some legal fuss first...
  14.  
  15.  
  16. DISCLAIMER
  17. ----------
  18.  
  19.     The  program  executable, its source code and information above is provided
  20. "as  is".   No  representations  or  warranties  are  made  with respect to the
  21. accuracy,  reliability, performance, currentness, or operation of this software
  22. and  information,  and  all use is at your own risk.  The author doesn't assume
  23. any  responsibility  or  liability  whatsoever  with respect to your use of the
  24. program and information.
  25.  
  26.  
  27. COPYRIGHT
  28. ---------
  29.  
  30.     SmartWB  is  published under "BeetWare" conception.  It's very special sort
  31. of  GiftWare.   It means you should send a beet to the author (but not a rotten
  32. one!   8).   Well, if you run short on beets send a disk or a small donation or
  33. anything else.  (Have a hint:  a bottle of beer would be excellent...  :)
  34.  
  35. This program can be freely distributed under following conditions:
  36.  
  37.  
  38. 1. Everything in this distribution must be kept together & unaltered.
  39.    Applies to:
  40.      - IconSpy            (the program itself)
  41.      - IconSpy.doc        (this doc file)
  42.      - IconSpy.doc.info
  43.      - IconSpy.info        (the icon, in MagicWB style :-)
  44.      - src/IconSpy.s        (source code)
  45.      - src/include/gcmacros.i    (my asm macros used in the source)
  46.  
  47. 2. Copyright notices are not removed from the source, executable and
  48.    documentation.
  49.  
  50. 3. No more then a nominal fee is charged to cover cost of magnetic media.
  51.  
  52. IconSpy is Copyright (C) 1994 The Beet Research. All rights reserved.
  53.  
  54.  
  55. INTRODUCTION
  56. ------------
  57.  
  58.     IconSpy  is  a  very simple proggie which monitors calls to GetDiskObject()
  59. and FindToolType() functions in icon.library.  It will show you any attempts to
  60. load  icons  or,  what  is more important, to find icon tool types.  Very often
  61. applications  get  some  options, preferences and so on via tool types.  And if
  62. the  doc  files  are  lost somewhere in the universe you simply don't know what
  63. tool  types  programs looks for!  Using IconSpy you can also discover some even
  64. secret tool types!  (Try it with IconEdit from Workbench3.0 :).
  65.  
  66.  
  67. USAGE
  68. -----
  69.  
  70.     IconSpy  can  be used from Shell and from Workbench as well.  When launched
  71. from  Shell  IconSpy  automatically  detaches itself from Shell and runs in the
  72. background.
  73.  
  74.        Options from Shell:
  75.  
  76.       WINDOW <str>        : Set other output for IconSpy. As a side
  77.                   effect not only console window can be
  78.                   specified but a filename, too. WINDOW
  79.                   can be abbreviated with WIN. Examples:
  80.  
  81.                   WINDOW="CON:0/200/640/100/IconSpy Window"
  82.                   WINDOW ram:iconspy.out
  83.                   WIN="CON:"
  84.                 
  85.                   NOTE: In case of window make sure that
  86.                         its size is at least 640 pixels wide
  87.                     or the window's contest will be
  88.                     distorted.
  89.                     
  90.       WBENABLE        : Enable tracing for calls made by Workbench
  91.                   tasks. By default it's disabled to avoid
  92.                   unusable mess in the window.
  93.  
  94.        Recognized Tool Types:
  95.        
  96.       WINDOW=<str>        : See above.
  97.                   Note: you cannot use the abbreviation.
  98.  
  99.       WBENABLE        : See above.  
  100.                   
  101.  
  102.     In  program  window  you  type  CTRL-C to exit IconSpy, or CTRL-D/CTRL-E to
  103. disable/enable monitoring respectively.  It's a little-SnoopDos-like :)
  104.  
  105. NOTE: IconSpy requires Kickstart V37 (2.04) or above to run!
  106.   
  107.  
  108.  
  109. OTHER
  110. -----
  111.  
  112.     No  doubt, IconSpy is really very small (3000 bytes, exactly :-) and simple
  113. program,  so  I  don't  think  there will be any _major_ update Therefore don't
  114. except  too much for future.  Especially GUI (scroll-bar, yeah...) and so on...
  115. If  you  want  to  have  a scroll-bar (which is indeed very useful) use console
  116. replacement  called  King-CON.   You  really  should  use it!  (Thanks to David
  117. Larsson for such a great work!).
  118.  
  119.     Note  that  included  icons  are  in  MagicWB  style.   If you still prefer
  120. 4-colour-ugly-look you will have probably to change them.
  121.  
  122.  
  123.  
  124. CONTACTING THE AUTHOR
  125. ---------------------
  126.  
  127.  
  128.     IF you find any bugs (or for any other reason), please contact me (only by
  129. Snail, pity):
  130.  
  131.         Grzegorz Calkowski
  132.         Rzedowice
  133.         ul.Dobrodzienska 8
  134.         42-780 Dobrodzien
  135.         POLAND
  136.  
  137.  
  138.                                 "Beeting is believing..."
  139.  
  140.                                             Signed: GC 8-1
  141.  
  142.  
  143. *******************************************************************************
  144.  
  145.                                    HISTORY:
  146.  
  147. v1.0 (09/08/94)
  148.  
  149.   o First release. (No doubt, easy to find bug here :-)
  150.  
  151.  
  152. v1.1 (30/08/94)
  153.  
  154.   o Window now autosizes to system default font.
  155.   o IconSpy now refuses to run if there is one already launched.
  156.   
  157.  
  158. v1.2 (27/10/94)
  159.  
  160.   o IconSpy didn't refuse to run again if was launched from Workbench. Fixed.
  161.   o Version string was incorrect. Fixed.
  162.   o Icon for this doc file included.
  163.   o Small optimizations.
  164.  
  165.